home *** CD-ROM | disk | FTP | other *** search
/ GFX Sensations 1 / Graphic Sensations - Volume 1.iso / tools / amiga / show / showgif.lha / ShowGIF.doc < prev    next >
Encoding:
Text File  |  1994-06-10  |  4.0 KB  |  155 lines
  1.  
  2.  
  3.             =========================
  4.  
  5.                  ShowGIF V1.0
  6.  
  7.             =========================
  8.  
  9.  
  10.                 June 10, 1994
  11.  
  12.  
  13.           Copyright (c) 1994 by Roman Hiestand
  14.  
  15.  
  16.  
  17.  
  18.  
  19. Copyright notice
  20. ----------------
  21.  
  22. The program ShowGIF and its documentation  are written and copyrighted by
  23. Roman Hiestand. They may be distributed freely providing the following
  24. restrictions are satisfied:
  25.  
  26. - Distributors may not charge more than the cost of a diskette used in
  27.   the distribution of this program.
  28.  
  29. - Distributors may only distribute the unmodified copy of the original
  30.   program,  source  file, along with it's documentation, and copyright
  31.   notices intact.
  32.  
  33. - Commercial  distribution  is  only  possible with written permission
  34.   from the author.
  35.  
  36.  
  37. Disclaimer
  38. ----------
  39.  
  40. This program and its documentation is provided "as is". No warranties are made
  41. with respect to the accuracy, reliability, performance or operation of this
  42. software and information. You are using this program at your own risk. The author
  43. is not liable for any damages that may have been caused by using this software.
  44.  
  45.  
  46.  
  47. Description
  48. -----------
  49.  
  50. ShowGIF is, as the name says, a GIF viewer for the Picasso-II graphics board of Village
  51. Tronic.
  52. The program can be started from CLI or Workbench with one or more file names/icons.
  53. It is meant to be fast and short, not user-friendly. This means, there are no options
  54. whatsoever; no parameters specifying the resolution, buffer size or alike. Just the
  55. file name.
  56. ShowGIF has been started as a programming exercise in Oberon. After a couple of days,
  57. it worked; but kinda slow. So I translated it into Assembler. It is very much easier
  58. translating an existing and running program than writing an assembly program from
  59. scratch. After another couple of days programming and optimising, ShowGIF was born.
  60.  
  61.  
  62. Command line options
  63. --------------------
  64.  
  65. Template: FILES/M
  66.  
  67.  
  68. Requirements
  69. ------------
  70.  
  71. Kick 2.0 and vilintuisup.library version > 2.0.
  72.  
  73.  
  74. Bugs
  75. ----
  76.  
  77. - well, not really a bug: if started from workbench, no error messages are printed
  78.  
  79. I could only test it on my machine (A3000 with Kick 2.0). No Enforcer hits have been found.
  80. If you find a bug, please report it to me together with as much information as possible
  81. that could help me to fix it: your computer, configuration, kick version and so on.
  82.  
  83.  
  84. Future plans
  85. ------------
  86.  
  87. - faster
  88. - quicker
  89. - shorter    :)
  90.  
  91. No, seriously: I don't know.
  92. Send me your ideas (apart from options which nobody uses).
  93.  
  94.  
  95. Notes about this program
  96. ------------------------
  97.  
  98. This program has been fully written in assembler. It is therefore very short and quite fast.
  99. The GIF decoding algorithm is mainly based on the c-source (jrdgif.c) of the jpeg software
  100. (version 4 of the jpeg software release), which itself is based on giftoppm. Many thanks
  101. to the JPEG group !
  102. It is pretty much optimised. Not only by the assembler (phxass is GREAT! Thanks to F. Wille),
  103. but also by hand. At this time, I can't think of another optimisation.
  104. When I compared ShowGIF to VT, I was pretty surprised because I didn't expect VT being so
  105. fast. Maybe I overlooked a couple of optimisations ...
  106.  
  107.  
  108.  
  109. Comparison table
  110. ----------------
  111. (Not representative)
  112.  
  113.  
  114.            ShowGIF V1.0        ViewGIF 1.6         VT_Picasso V2.1
  115.                     from VillageTronic
  116.            ----------------------------------------------------------------------
  117.  
  118. Executable size        2352          19376                 84584
  119. display time (~,secs)      15             33                15
  120. Mem needed (~)          1.5 MB         1.6 MB                3.4 MB
  121. (including display
  122.  memory)
  123.  
  124. (time & mem are measured with 'globe.gif' (547365 bytes), a picture converted from
  125. 'globe.jpg' of NASA. Program & image are on harddisk.)
  126.  
  127. These are just typical values. The differences become smaller with smaller images, and
  128. larger if the image is on ram-disk.
  129.  
  130. Alright, VT is neither a pure GIF-viewer nor optimised for the Picasso-board. But
  131. ViewGIF 1.6 is ...  :)
  132.  
  133.  
  134.  
  135. Revisions
  136. ---------
  137.  
  138.     1.0    -    first public release
  139.  
  140.  
  141.  
  142. Address
  143. -------
  144.  
  145. I can be reached at
  146.  
  147. Roman Hiestand
  148. Luziaweg 15
  149. CH-8807 Freienbach
  150. Switzerland
  151.  
  152. Fax: CH-055/48 26 37
  153.  
  154. email: rhiestan@iiic.ethz.ch
  155.